home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / adjram41.zip / ADJRAM.DOC < prev    next >
Text File  |  1988-05-15  |  61KB  |  1,257 lines
  1.  
  2.  
  3.  
  4.                           ADJRAM -- Adjustable RAM Disk
  5.                                      
  6.                                 by Gary Cramblitt
  7.  
  8.                                    Version 4.1
  9.  
  10.         (c) Copyright 1986,1987,1988 by Gary Cramblitt.  All rights 
  11.             reserved.  Permission is granted to copy and use this 
  12.             software for non-commercial purposes only.  Permission is 
  13.             granted to distribute copies of this software provided no 
  14.             profit is obtained by doing so and that the entire package 
  15.             is distributed.  
  16.  
  17.             NOTICE:  This program is provided on an "as is" basis 
  18.             without warranty of any kind, expressed or implied, 
  19.             including but not limited to the implied warranties of 
  20.             mercantability and fitness for a particular purpose.  The 
  21.             entire risk as to quality and performance of this program is 
  22.             with you, the user.  Should the program prove defective, you 
  23.             assume the entire cost of all necessary repair, servicing, 
  24.             or correction.  In no event will the author be liable to you 
  25.             for any damages, including any lost profits, lost savings, 
  26.             or other incidental or consequential damages arising out of 
  27.             the use or inability to use this program.
  28.  
  29.  
  30.         This program, although copyrighted, may be freely copied and 
  31.         used, so long as it is not used for commercial purposes.  It is 
  32.         NOT shareware or user-supported software.  You are not expected 
  33.         to make a donation to the author for using this program.  Enjoy 
  34.         -- and try to do the same for others some day.  
  35.  
  36.         If you distribute copies of this software to others, you are 
  37.         REQUIRED to distribute the ENTIRE package consisting of the 
  38.         following files: 
  39.  
  40.                 AMDISK.DVD
  41.                 ADJRAM.EXE
  42.                 ADJRAMEM.EXE
  43.                 ADJRAM.DOC
  44.                 AMDISK.ASM
  45.                 ADJRAM.C
  46.  
  47.         If you leave any of the above files out, you will be in 
  48.         violation of copyright.  You may charge a distribution fee for 
  49.         ADJRAM so long as the recipient is not charged more than a total 
  50.         of $6.00 (including tax and postage) to receive ADJRAM.  If you 
  51.         charge more than that, you are in violation of copyright.  
  52.  
  53.         
  54.         READ THIS DOCUMENTATION
  55.         -----------------------
  56.         Using this program without first reading all of this document 
  57.         can be hazardous to your data.  While the program has been 
  58.         reasonably tested for defects, the nature of its algorithm is 
  59.         such that under certain conditions it will fail and this could 
  60.         in turn cause loss of valuable data.  The section on 
  61.         Compatibility and Memory Usage and the section on Errors are 
  62.         particularly important.  
  63.  
  64.  
  65.         What Is ADJRAM?
  66.         ---------------
  67.         ADJRAM is a RAM disk program.  Sometimes, RAM disks are called 
  68.         "virtual disks" like the VDISK supplied with PC-DOS.  Sometimes 
  69.         they are called "memory disks" like MEMBRAIN.  Whatever you call 
  70.         it, a RAM disk is a program that makes a section of the Random 
  71.         Access Memory (RAM) of your computer look like a floppy disk 
  72.         drive to DOS.  The advantage is that RAM is many hundreds of 
  73.         times faster than a floppy disk -- even faster than a hard disk.  
  74.  
  75.         Why use ADJRAM, when you already have VDISK or MEMBRAIN or some 
  76.         other RAM disk?  Because ADJRAM allows you to vary the size of 
  77.         the RAM disk without rebooting, and without loss of existing 
  78.         data stored in the RAM disk.  For example, you can start out 
  79.         with 64K of your memory allocated for the RAM disk, expand it 
  80.         later to 320K, copy a document file of 60K to the RAM disk, and 
  81.         still later reduce the RAM disk capacity back down to 128K -- 
  82.         without losing your document file.
  83.  
  84.         ADJRAM is ideal for those who do not have a hard disk.  It also 
  85.         supports LOTUS/INTEL/Microsoft Expanded Memory and Reserved 
  86.         Memory (explained later).  It does not support Extended Memory.
  87.  
  88.         Requirements
  89.         ------------
  90.         ADJRAM is designed to run under MS-DOS version 2 or greater.  It 
  91.         has been tested on the following machines:
  92.  
  93.              1.  Zenith Z100 under MS-DOS version 2.21
  94.              2.  Zenith Z171 (an IBM PC compatible) under MS-DOS version 
  95.                  2.11
  96.              3.  KayPro 16 also under MS-DOS 2.11
  97.              4.  Tandy 1000 under MS-DOS 2.11
  98.              5.  Sperry Personal Computer with 2 Mbyte JRAM 3 card under 
  99.                  MS-DOS 3.1 
  100.              6.  EPSON Equity I under MS-DOS 2.11 
  101.              7.  COMPAQ DeskPro (80186) under IBM DOS 3.10
  102.              8.  IBM PC Portable.  
  103.              9.  Sharp PC-5000.
  104.              10. Zenith Z160 under DOS 3.1.
  105.              11. XEROX 6060 under MS-DOS 3.1.
  106.              12. Epson Equity I under MS-DOS 2.11.
  107.  
  108.         It requires approximately 14K bytes of disk space.  Memory usage 
  109.         is, of course, a function of the RAM disk's size, but it 
  110.         requires a minimum of 50K free RAM.  
  111.  
  112.  
  113.         Installation
  114.         ------------
  115.         Note: If you have a computer with LOTUS/INTEL/Microsoft Expanded 
  116.               Memory and you want ADJRAM to use the Expanded Memory, 
  117.               please read the section below entitled "Expanded Memory 
  118.               Support" before you install ADJRAM.  
  119.  
  120.         Copy the following files to your boot disk: 
  121.  
  122.              AMDISK.DVD
  123.              ADJRAM.EXE
  124.  
  125.         Edit your CONFIG.SYS file and place the following line in it:
  126.  
  127.              device = amdisk.dvd
  128.  
  129.         Reboot your computer.  If all goes well, you should see the 
  130.         following message appear near the beginning of your boot 
  131.         sequence:
  132.  
  133.              AMDISK v4.1 (c) Copyright 1986,1987,1988 by Gary Cramblitt
  134.                -- Initialized as disk C:
  135.  
  136.         The disk drive letter will vary according to your system 
  137.         configuration.  Remember that drive letter, since it is that 
  138.         disk which is your RAM disk.  
  139.  
  140.         If you use any memory resident programs, such as Sidekick (a 
  141.         trademark of Borland International), load them before attempting 
  142.         to change the size of the RAM disk (as explained in the next 
  143.         section).  
  144.         
  145.         MS-DOS 3.x users may need to add a LASTDRIVE= clause to their 
  146.         CONFIG.SYS file.  Consult your DOS manual.
  147.  
  148.                                                         
  149.         Using the RAM Disk
  150.         ------------------
  151.         The RAM disk is used just like any floppy disk drive.  You can 
  152.         copy files to or from it, create directories on it, erase files, 
  153.         etc.  You may NOT do the following things with the RAM disk:
  154.         
  155.              1.  You may not FORMAT the RAM disk.
  156.              2.  You may not DISKCOPY from or to the RAM disk.
  157.              3.  You may not run SYS against the RAM disk.
  158.              4.  You may not boot from the RAM disk.
  159.              5.  You may not use any program on the RAM disk that 
  160.                  accesses the disk controller circuitry directly.  Some 
  161.                  anti-copy protection programs fall into this category.
  162.              6.  You may not use any program that depends upon IBM
  163.                  standard disk media codes.
  164.  
  165.         Restrictions 1 through 5 are generally true of any RAM disk.  
  166.         Restriction 6 is unique to the Adjustable RAM Disk because it 
  167.         uses a non-standard media descriptor byte.  This shouldn't cause 
  168.         great hardship though.  
  169.  
  170.         Also, keep in mind that anything stored in the RAM disk can 
  171.         potentially be lost.  For example, should your power fail and 
  172.         you don't have an Uninterruptible Power Source (UPS), then 
  173.         everything in the RAM disk will be lost.  If you reboot (by 
  174.         pressing CTRL-ALT-DEL for example), t